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Abstract 
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gathers  its  inputs  either  from  static  data  files  or  a  streaming  input  source. 

This  report  describes  the  AlS-Indexer  functionalities  provided  to  the  user.  It  also  describes 
how  to  install  and  configure  the  application.  This  application  was  initially  developed  in 
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1  Getting  Started 


This  section  describes  how  to  start  and  configure  the  AIS  Indexer. 

1.1  Installation  and  Setup 

The  AIS  Indexer  is  packaged  in  a  .jar  file  and  can  be  run  from  any  location  on  the  file 
system.  It  is  recommended  however  that  the  jar  file  be  placed  in  its  own  separate  folder, 
e.g.  AlS-Indexer,  asit  will  make  file  navigation  easier  in  the  long  run. 

In  order  to  publish  maps  to  the  GeoNetwork  site,  a  publisher  script  provided  with  the  in¬ 
stallation  package  (zipped  under  GeoNetworkScript .  zip)  needs  to  be  present  somewhere 
on  the  local  disk.  The  simplest  solution  is  to  place  the  script  in  a  folder  placed  in  the  same 
folder  as  the  jar  file. 


Map  Indexing  Application  I  About 


Generate  Map 

Open  Map 


Figure  1:  A  view  of  the  AIS  Indexer  after  running  the  jar  exeeutable. 

To  setup  the  application  requires  running  the  jar  file  once  by  double  clicking  on  it  then  clos¬ 
ing  it  (Figure  1  shows  the  AIS  Indexer  at  startup).  To  close  the  application,  simply  click 
on  the  X  button  on  the  top-right  comer  of  the  window.  Running  the  application  will  gener¬ 
ate  3  new  subfolders  (Config,  Monitored  Alerts,  and  Saved  Maps).  The  screenshot  in 
Figure  2  below  shows  a  typical  file  stmcture  after  running  the  jar  file. 

1.2  Installation  and  Setup 

Close  the  AIS  Indexer  and  open  the  Config  folder  and  the  app .  config  file  within.  The 
HostName  and  Port  parameters  define  the  socket  connection  used  by  the  AIS  Indexer  to 
retrieve  live  AIS  messages.  Replace  localhost  and  9999  respectively  with  the  socket 
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Name 


Date  modified  Type 


Size 


JL  Config 

^  GeoNetworkScript 
^  Monitored  Alerts 
JL  Saved  Maps 
AlS-Indexer 


25/11/2012  4:02  PM  File  folder 
25/11/2012  4:04  PM  File  folder 
25/11/2012  4:02  PM  File  folder 
25/11/2012  4:02  PM  File  folder 


25/11/2012  4:01  PM  Executable  Jar  File 


756  KB 


Figure  2:  The  recommended  installation  structure. 


Internet  Protocol  (IP)  and  port  values  you  wish  to  connect  to.  Set  the  publisher  path  to  the 
location  of  the  publish .  py  script.  See  below  for  an  example: 

PublisherPath=C: \Us ers\Username\workspace\AIS- Indexer \GeoNetwor kScr ipt \publ ish .py 

Note  that  the  AIS  Indexer  must  be  run  at  least  once  to  create  the  app .  config  file. 


1.3  Starting  The  Application  From  The  Command  Line 


Starting  the  application  from  the  command  line  is  not  necessary  but  it  does  have  some 
advantages,  the  most  important  of  which  is  the  ability  to  specify  the  amount  of  memory 
usable  by  the  application. 

To  do  this  (on  the  Windows  Operating  System),  first  open  a  command  interface  by  typing 
cmd  in  the  search  bar  right  above  the  Windows  button  and  then  pressing  Enter.  The  cmd 
path  should  point  to  C:  \Users\Username  by  default.  Use  the  cd  <filepath>  command 
to  navigate  to  the  AIS- Indexer  folder. 

To  run  the  application  with  a  specified  memory  size  (e.g.  1  Gigabyte  (GB))  type: 

java  -jar  -XmxI024m  AlS-Indexer . jar 

where  -XmxI024  sets  the  maximal  amount  of  memory  used  to  1024  megabytes  (or  1GB). 
Large  maps  will  require  a  lot  of  memory  so  this  procedure  is  generally  recommended. 
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2  Generating  Maps 


This  section  explains  how  to  generate  maps  using  the  AIS  Indexer  application.  Figure  3 
illustrates  the  options  left  to  the  user  from  the  Main  Panel,  generate  a  map  or  open  an 
existing  map.  To  start  off  map  generation  click  the  Generate  Map  button. 


Figure  3:  The  user  can  generate  a  new  map  or  open  an  existing  map. 


2.1  Options  Panel 

After  clicking  on  Generate  Map,  the  user  is  presented  with  the  choice  of  Static  or  Live 
map.  Clicking  on  either  one  will  reveal  more  options  specific  to  the  selected  map  type. 

2.2  Static  Map  Generation 

To  generate  a  map  from  a  static  log  file,  use  the  file  explorer  to  navigate  to  the  file  you  wish 
to  add  and  click  the  Add  button  in  the  bottom  right  corner.  See  Figure  4  for  a  view  of  the 
file  explorer.  Several  files  can  be  added  when  generating  a  single  map,  however  the  same 
log  file  cannot  be  included  twice. 

Log  files  are  not  provided  with  the  installation  package.  These  files  are  generated  by  other 
scripts  already  in  the  possession  of  Defence  Research  and  Development  Canada  (DRDC) 
(see  annex  of  [2]  for  an  example  of  such  a  file). 

The  user  can  also  include  map-specific  options  in  the  options  panel  after  selecting  the  map 
type.  See  Figure  5  for  a  screenshot  of  the  option  panel  in  the  static  case.  For  the  static  case, 
the  user  can  specify  the  map’s  start  and  end  date,  the  geographic  bounding  box  and  the  cell 
precision.  The  only  mandatory  field  is  the  cell  precision  which  dictates  the  resolution  of  the 
map.  The  smaller  the  cell  size,  the  higher  the  map  resolution.  If  the  time  and  geographic 
bounds  are  not  specified  (all  0  or  empty  by  default),  the  map  will  be  generated  with  all 
the  data  available  in  the  selected  log  file(s).  Conversely,  specifying  geographic  and  time 
bounds  will  exclude  the  AIS  reports  in  the  logs,  that  are  outside  of  the  specified  bounds. 
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Select  log  files  to  include  in  map: 


Lookln:  [Q  OODA  |  - 1  [ffl]  [gj  | gS| gz | 

Connect 

Monitored  Alerts 
^  Saved  Maps 
n  ubuntu_12.04 
□  AISIndexer-20121107.iar 
Q  aistestdata-reduced.txt 
Q  putty.exe 
Q  socketserver.py 


File  Name:  aistestdata-reduced.txt 

Files  of  Type:  |aiI  Files 


Add  ^ 


Figure  4:  Screenshot  of  the  hie  explorer  displayed  to  the  user  for  the  static  map  generation. 


Some  restrictions  apply  when  specifying  bounds.  In  the  case  of  time  bounds,  the  end  time 
must  take  place  after  the  start  time.  In  the  case  of  geographic  bounds,  the  northern  latitude 
must  be  greater  than  the  southern  latitude  and  the  eastern  longitude  must  be  greater  than 
the  western  longitude.  Furthermore,  latitude  values  range  between  [-90.00,  90.00]  degrees 
and  Longitude  values  range  between  [-180.00,  180.00]  degrees. 

By  clicking  the  Run  button,  the  map  will  be  generated  with  the  user  specified  options. 

2.3  Live  Map  Generation 

Generating  live  maps  is  similar  to  the  static  case  with  two  major  distinctions,  the  first 
is  that  all  boundary  options  must  be  specified  (there  are  no  default  values).  The  second 
difference  is  that  for  the  live  case  the  start  and  end  times  are  replaced  by  the  window  period 
and  refresh  interval.  The  window  period  represents  the  length  of  time  data  are  included 
in  the  map  while  the  refresh  interval  represents  how  often  the  map  will  be  generated.  For 
example,  a  map  can  contain  a  total  of  12  hours  worth  of  AIS  data  (the  window  period),  and 
can  refresh  every  4  hours. 
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Generate  Map  \/ 


Map  Type 

[static 

Tffne  Bounds 


Setstarttime  x  2010/09/30,22:00 
Set  end  time  x  2010/10/01,00:00 


Detta  T  (min):  \  6[Tj 

Geographic  bounds 

North  Lat  (deg):  |  70^ 

West  Long  (deg):  \  -140^ 

South  Lat  (deg):  | 

East  Long  (deg):  |  -30^ 

Cel  precision 

Horizontai  (deg):  f  O^ll^ 

Vertica!(deg):  )  O.lT^. 


Run 


Figure  5:  Screenshot  of  the  option  panel  in  the  static  map  case. 
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3  Viewing  Maps 


All  maps  are  viewed  in  the  Map  Viewer  window  (see  Figure  6).  This  interfaee  allows  the 
user  to  navigate  the  map  by  zooming  with  the  mouse  wheel  and  elieking  and  dragging  the 
map  in  the  same  way  he/she  would  use  Google  Maps  ^ .  The  Map  Viewer  also  eontains  a 
panel  detailing  all  the  speeifies  of  the  eurrent  map  ineluding  time  and  geographie  bounds 
as  well  as  monitoring  info. 


Map  Viewer 


Coverage  Info 
Map  Size  (deg): 

Cell  size  (deg): 

Start  Time: 

End  Time: 

Duration: 

Delta  T  (min): 
Monitoring  Info 
Total  Alerts: 

AJS  Absent  Ships: 

AIS  Now  Present  Ships: 


330x173 
1.0  X  1.0 

2012/10/11.21:00 

2012/10/11.21-14 

OhOSmOOs 
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Publish  to  GeoNetwork 


Cell  Index  Threshold:  |o.975  | 

Monitor  Ship  Traffic 


\ ,  ^ 


, 


Long : 


-9.43  Lat:  -14.53 


Figure  6:  Screenshot  of  the  Map  Viewer  window.  Notice  the  outline  of  North  America, 
the  Baltic,  the  Mediterranean,  and  North  Afriea. 


1.  https://maps.google.com/ 
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4  Loading  Maps 


Whenever  a  map  is  generated  by  the  AIS  Indexer,  it  is  automatieally  saved  in  the  Saved 
Maps  folder  as  a  text  file.  These  text  files  ean  be  loaded  at  any  time  and  viewed  in  a  Map 
Viewer. 

To  open  a  saved  map,  from  the  Main  Panel,  eliek  on  Open  Map  and  use  the  file  explorer  to 
navigate  to  the  map  you  wish  to  open,  seleet  it  then  eliek  the  Open  button.  See  Figure  7  for 
a  view  of  the  file  explorer. 


Map  Indexing  Application  About 


Select  map  to  open; 


Generate  Map 


Open  Map 


Look  in;  [g  Saved  Maps  j^l  |g:g:|gz| 

D  20121126_map_0.txt 
D  20121126_map_1.ut 
Q  20121126_map_2.ttt 
D  20121126_map_3.txt 
D  20121126_map_4.txt 
D  20121126_map_5.Ut 
D  20121126_map_6.Ut 
D  20121126_map_7ji[ij 


File  Name: 

120121126  map  7,W 

Fites  ofljrpe: 

[Map  files  (*.txt) 

Open 


Figure  7:  Screenshot  of  the  hie  explorer  displayed  to  the  user  when  loading  existing  maps. 
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5  Monitoring  Ship  Traffic 


From  the  Map  Viewer  interface,  the  user  can  also  monitor  live  ship  traffic.  Monitoring 
uses  the  same  socket  connection  as  live  map  generation  however  the  two  processes  are 
completely  separate.  In  short,  monitoring  ship  traffic  compares  incoming  AIS  messages 
to  the  current  map.  If  a  message  originates  from  a  cell  with  a  strong  reception  index,  the 
ship  that  reported  the  message  will  be  expected  to  report  again.  If  it  doesn’t,  an  alert  will 
appear  on  the  right  hand  panel  of  the  Map  Viewer.  The  user  will  also  be  alerted  of  ships 
that  reappear  after  having  been  reported  as  missing.  For  a  more  detailed  description  of  how 
monitoring  works,  refer  to  [2]. 

The  monitoring  panel  includes  the  option  to  set  the  index  threshold  for  ships  to  be  mon¬ 
itored.  AIS  messages  that  originate  from  cells  with  indices  below  this  threshold  will  be 
ignored. 

When  an  alert  appears,  selecting  it  will  place  a  marker  on  the  map  indicating  the  position 
of  origin  of  the  AIS  report  that  triggered  the  alert.  See  Figure  8  for  an  example  of  the  alerts 
list  and  display  on  the  map. 

All  alerts  are  saved  to  a  file  in  the  Monitored  Alerts  folder.  These  files  represent  a 
monitoring  session.  A  session  starts  when  the  monitoring  button  is  toggled  on  and  ends 
when  it  is  toggled  off  or  the  user  closes  the  Map  Viewer. 


Coverage  Info 
Map  Size  (dep): 

Cel  size  (deg): 

Sian  Time: 

End  Time: 

CXiiatKHi: 

OelieT(mm|: 
Monitoring  Info 
Total  Alerts: 

AIS  Absent  Slups: 

AIS  Now  Preseni  Stilps: 


Ship  Must  316006894, 
Ship  Must  211262460, 
Shv  Must  367141430, 
Shv  MM»:  367479870, 
Ship  Must  367483840, 
367483840, 
Ship  Must  367423000, 
Ship  Must  366927010, 
Ship  Must  367479870, 
Ship  Must  367141430, 
ShipMUSt311732000, 
Ship  Must  311732000, 
Shv  Must  366998310, 
Shv  MMSt  367423170, 
Shv  MM».- S7672SOOO, 
Shv  Must  366998310, 
Shv  Must  366996250, 
Shv  Must  366995820, 
Ship  Must  576725000, 
Shv  MMSt  367436230, 
Shv  MMSt  345070140, 
Shv  Must  367004030, 
Shv  Must  367501870, 
ShV  Must  366943970, 
ShV  Must  235001720, 
Shv  Must  636090990, 
367081990, 
387127730, 
Shv  MMSt  366995820, 
Shv  MMSt  211262460, 
Shv  MMSt  636091501, 
Shv  MMSt  345020012. 
Shv  MMSt  309548000, 


Type: 
AienType: 
AlenType; 
Alert  Type: 
AlenType: 
AlenType: 
AienType: 
AlenType: 
Alen  Type: 
AlenType: 

Type: 
Alen  Type: 
Alen  Type: 
AienType: 
AlenType; 
Alen  Type: 
Alen  Type: 
AlenType: 
AlenType: 
Alen  Type: 
AlenType: 

Type: 
AlenType: 
AlenType: 
Type; 
Type: 
Alen  Type: 
Alen  Type: 
Alen  Type: 
AlenType: 
AlenType: 
AlenType: 
Type: 


Missing,  Long:  -83.11.  Lac  42.10,  Index:  1.0 
AIS  Now  Present,  Long:  -116.18,  Lac  28.68,  Index:  i 
AIS  Now  Present,  Long:  -7639,  Lac  35.22.  Index;  0 
AIS  Now  Present,  Long:  -9137,  LaC  29.07.  Index:  0 
Al  S  Now  Present.  Long;  -90.02,  Lat  29.1 5.  Index:  0.0 
Missing,  Long:  -90.02,  LaC  29.15.  Index:  1.0 
Missing.  Long;  36.77,  Lac  18.01.  index:  1.0 
Missing.  Long;  -89.61,  Lac  29.15,  Index:  1,0 
Missing,  Long:  -9137,  Lac  29.07.  Index:  1.0 
Missing,  Long:  -7649,  Lac  35.15,  Vdex:  1.0 
Al  S  New  Present.  Long:  -1 30.01 ,  Lee  3136,  index:  6k 
Missing,  Long:  -129.95,  Lac  31.57,  Index:  1.0 
AIS  Now  Present,  Long:  39.13,  LaC  29.86,  Index;  0.0 
Missing,  Long;  -76.42,  Lac  37.26.  Index:  13 
AIS  Now  Present  Long;  37.21,  Lat  30.40,  hide 
Missing.  Long:  49.13.  LaC  2936.  Index:  13 
AIS  Now  Present  Long:  -92.93,  lat  29.93.  Index:  03 
AIS  Now  PresenL  Long;  -94.19,  LaC  29.68.  Index;  0.0 
Missing,  long:  3731,  Lac  30.40.  index:  1.0 
Missing,  Long:  -12241.  Lee  3731,  Index- 1.0 
Missing,  Long;  -91.91,  Lac  18.86,  Index;  1,0 
Missing,  long;  38.77,  Lac  29.32,  Index:  1.0 
Missing.  Long;  -91.55,  Lac  29.72,  Index  1.0 
Missing.  Long:  -117.69,  Lac  33.46,  index  1.0 
Missing,  Long;  -70.64,  Lat  39.74,  Index:  13 
AIS  Now  PresenL  Long:  -113.95,  LaC  24.07,  IndexOi 
AIS  Now  Present,  Long:  34.05,  Lac  29.18,  Index:  0.1 
AIS  Now  Present  Long:  -90.02,  Lat  29.03,  Index  0.0 
Missing,  long;  -94.15,  Lat  29.69.  Index:  1.0 
Missing,  Long:  -116.12.  Lac  28.54,  Index  13 
Missing,  Long:  -7944,  Lat  32.61.  Index;  1.0 
Hissing.  Long;  -11445,  Lac  2303,  Index:  13 
AIS  Now  Present  tong:  -95.07,  Lat  28.77.  index  0.0 


Countdown  to  next  map  coverage  0:09:38 


Figure  8:  Screenshot  of  the  Map  Viewer  when  the  ship  monitoring  is  on.  The  position  of 
the  selected  alert  (on  the  right  side)  is  displayed  on  the  map  with  a  cross. 
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6  Publishing  Maps  To  GeoNetwork 


From  the  Map  Viewer,  the  user  ean  also  publish  the  eurrent  map  to  the  GeoNetwork  website 
by  elicking  on  the  Publish  to  GeoNetwork  button.  In  the  ease  of  live  maps,  the  button  is 
toggable  and  maps  will  be  published  as  they  continue  refreshing.  In  the  case  of  static 
and  loaded  maps,  the  button  can  simply  be  clicked  once  to  publish  the  map.  The  Publish 
to  GeoNetwork  button  is  in  the  left  part  of  the  Map  Viewer  (see  Figure  6  and  8).  This 
functionality  assumes  that  GeoNetwork  is  up  and  running  on  the  network.  Refer  to  [3]  for 
more  details  about  the  publishing  functionality. 

The  user  is  warned  however  to  avoid  publishing  live  maps  with  high  refresh  rates.  For  ex¬ 
ample,  if  a  map  that  refreshes  every  2  min  is  left  running  for  one  hour,  then  the  GeoNetwork 
site  will  have  received  30  publications  by  the  end  of  the  hour.  Deleting  these  publications 
must  be  done  case  by  case  and  can  become  tedious.  To  facilitate  long  term  maintenance,  it 
is  therefore  preferable  to  publish  sparingly. 
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List  of 

symbols/abbreviations/acronyms/initialisms 


AIS 

Automatic  Identification  System 

AOI 

Area  Of  Interest 

DRDC 

Defence  Researeh  and  Development  Canada 

FIFO 

First-In,  First-Out 

GB 

Gigabyte 

hrs 

hours 

IP 

Internet  Protoeol 

min 

minutes 

ms 

milliseconds 

MSARI 

Maritime  Situational  Awareness  Researeh  Infrastrueture 

MSSIS 

Maritime  Safety  and  Seeurity  Information  System 

MVP 

Model  View  Presenter 

s 

seconds 

Ul 

user  interface 
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